List My CRM Positions

GET 
/api/v1/users/me/positions

Lists only the authenticated personal-token user's eligible CRM positions in the token workspace and organization. This bootstrap endpoint requires crm:read and does not require X-Smackdab-Position-UUID. Choose data.items[].uuid, or a UUID from error.details.available_positions[].uuid after PUBLIC_POSITION_REQUIRED, and retry normal requests with that UUID in X-Smackdab-Position-UUID. A single eligible position is selected automatically on normal requests. An empty list means a CRM administrator must assign a position; normal routes return PUBLIC_POSITION_NOT_AVAILABLE. Legacy API keys receive PUBLIC_PERSONAL_TOKEN_REQUIRED.

Responses

200

Available CRM positions retrieved.

401

Canonical v1 public API error envelope. Legacy API-key endpoints may retain the older data/message/responseType response during migration.

403

The personal-token user has no eligible CRM position; an administrator must assign one.

429

Rate limit exceeded

Response Headers

X-RateLimit-Plan

Active public API plan applied to the request. Free and Kickstarter are blocked before rate buckets are consumed.

X-RateLimit-Bucket

Rate-limit bucket used for the request. List-style POST endpoints are counted as reads; mutation endpoints are counted as writes.

X-RateLimit-Limit

Maximum number of requests allowed for the active bucket in the current one-second rate-limit window.

X-RateLimit-Limit-Read

Maximum read requests allowed per second for the active plan. Pro is 100; Unlimited is 500.

X-RateLimit-Limit-Write

Maximum write requests allowed per second for the active plan. Pro is 25; Unlimited is 125.

X-RateLimit-Remaining

Number of requests remaining for the active bucket in the current one-second rate-limit window.

X-RateLimit-Reset

Unix timestamp, in seconds, when the current rate-limit window resets.

Retry-After

HTTP date when the current limit resets. Present on 429 responses.

503

Personal access token validation is temporarily unavailable.