Get Partner Entity
Returns a resolved entity by ID within a partner organization scope.
Looks up a UUID across organizations using partner authentication and returns
the resource type plus enough context to fetch the canonical resource.
This endpoint is intended for cross-organization partner workflows where the
caller has an arbitrary UUID and needs to discover both the resource type and
the organization it belongs to.
The response always includes:
- `id`: the UUID that was resolved.
- `type`: the resolved entity type.
- `canonical_path`: the canonical REST path for the resolved resource.
- `organization_id`: the organization that owns the resolved resource.
The response may also include:
- `relationships`: parent resources needed to address nested resources.
- `context`: lightweight additional context, such as bulk sync `schema_ids`.
Supported `type` values currently include:
- `organization`
- `user`
- `connection`
- `model`
- `sync`
- `sync_execution`
- `bulk_sync`
- `bulk_sync_execution`
Examples:
- A model sync execution resolves to a `sync_execution` and includes a `sync`
relationship.
- A bulk sync execution resolves to a `bulk_sync_execution`, includes a
`bulk_sync` relationship, and may include `context.schema_ids`.
If the UUID does not exist, the endpoint returns `404`.
Authentication
AuthorizationBearer
Bearer partner API key
Path parameters
id
UUID of the entity to resolve.
Headers
X-Polytomic-Version
Response
OK
data
Errors
403
Forbidden Error
404
Not Found Error
500
Internal Server Error
