Import a tracking plan from CSV
이 페이지는 아직 귀하의 언어로 번역되지 않았습니다. 현재 작업 중이므로 곧 다시 확인해 주십시오.
Sends a tracking-plan CSV as the request body and applies it to a new import branch.
This endpoint always imports into a branch and never writes to main directly.
Creating the branch publishes any pending changes on main's staging version
first, as creating a branch in the product does. When the import fails after
the branch was created (422 for invalid rows, 502 for a server failure), the
error payload includes details.branch so callers can inspect or delete the
branch. A duplicate branch_name returns 409 before anything is created.
/v1/projects/{project_id}/tracking-plan/importAuthorizations
Authorizationstringrequiredhttp
Path parameters
project_idstringrequiredAmplitude project identifier, backed by the canonical app ID.
12345pattern: ^[0-9]+$Query parameters
branch_namestringOptional name for the import branch, 1 to 256 characters. When omitted,
the import uses import, or import-N if that name is taken. A name
that already exists returns 409.
min length: 1max length: 256Body
text/csvvaluestringResponse
application/jsondataobjectrequiredShow child attributes
objectstringrequiredtracking_plan_importproject_idstringrequiredbranch_idstringrequiredbranch_namestringnullablecurrent_version_idstringnullablestaging_version_idstringnullableimport_typestringrequiredPublic import target type. events includes event, template,
event-property, and template-property rows; user_properties
includes user-property rows.
eventsuser_propertiesevent_countintegerrequiredtemplate_countintegerrequireduser_property_countintegerrequiredbreakdownobjectPer-type import counters. Units:
- templates/events/user_properties: definition rows changed.
- template_properties/event_properties
created|updated:
property definition rows changed.
- template_properties/event_properties
unmapped: properties
removed from templates/events; the property definition is kept.
nullabletemplatesobjectcreatedintegerrequiredupdatedintegerrequiredremovedintegerrequiredtemplate_propertiesobjectcreatedintegerrequiredupdatedintegerrequiredunmappedintegerrequiredeventsobjectcreatedintegerrequiredupdatedintegerrequiredremovedintegerrequiredevent_propertiesobjectcreatedintegerrequiredupdatedintegerrequiredunmappedintegerrequireduser_propertiesobjectcreatedintegerrequiredupdatedintegerrequiredremovedintegerrequiredbranch_name already exists. Nothing was created; choose
another name.
typestringrequiredformat: urititlestringrequiredstatusintegerrequiredmin: 400max: 599detailstringnullabledetailsobjectnullableinstancestringformat: urinullableerror_codestringrequiredretryablebooleanrequiredretry_after_secondsintegernullablemin: 0validation_errorsobject[]nullabledetails.branch is present when
the error was found after the import branch was created.
typestringrequiredformat: urititlestringrequiredstatusintegerrequiredmin: 400max: 599detailstringnullabledetailsobjectnullableShow child attributes
branchobjectidstringrequirednamestringrequiredinstancestringformat: urinullableerror_codestringrequiredretryablebooleanrequiredretry_after_secondsintegernullablemin: 0validation_errorsobject[]nullabledetails.branch is present
(the branch was created) or when the connection was lost mid-import (the
import may have started): a retry could create a second branch. List the
project's branches to find the result. A 502 without details.branch
that is marked retryable means the import was never started.
typestringrequiredformat: urititlestringrequiredstatusintegerrequiredmin: 400max: 599detailstringnullabledetailsobjectnullableShow child attributes
branchobjectidstringrequirednamestringrequiredinstancestringformat: urinullableerror_codestringrequiredretryablebooleanrequiredretry_after_secondsintegernullablemin: 0validation_errorsobject[]nullabletypestringrequiredformat: urititlestringrequiredstatusintegerrequiredmin: 400max: 599detailstringnullabledetailsobjectnullableinstancestringformat: urinullableerror_codestringrequiredretryablebooleanrequiredretry_after_secondsintegernullablemin: 0validation_errorsobject[]nullable이 내용이 도움이 되었나요?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.