{"openapi":"3.1.0","info":{"title":"looktme API","version":"1.0.0","description":"Stable, versioned under /v1: within v1 we add fields but don't remove or rename them, except when a network's API or policy, security or the law requires it; we announce breaking changes at least 30 days in advance where practicable. Integrations should ignore fields they don't recognize. Every response carries X-RateLimit-* headers. Errors share one shape: { message, code, requestId }. Keys have scopes: read (list and status), draft (create drafts), schedule (schedule posts), publish (agent posting on X; explicit opt-in only, never granted by default). Create drafts and schedule posts with a looktme API key. Agent posts are drafts that a person approves in looktme, unless a workspace owner or the person who connected the account turned on agent publishing for that Instagram or Threads account. TikTok and Pinterest posts always stay as drafts. LinkedIn and X are draft_only: agents may create drafts there, but can't publish, schedule or approve them; each LinkedIn or X version returns an approvalUrl (valid 72 hours) that the person opens, signed in to looktme, to review, edit and approve that one post. Approval has no API equivalent. Agent drafts are marked aiGenerated. YouTube isn't available."},"servers":[{"url":"https://api.looktme.com"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Authorization: Bearer ltk_... (Settings > API keys)"}},"schemas":{"Error":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Human-readable"},"code":{"type":"string","description":"Stable machine code, e.g. UNAUTHORIZED, VALIDATION_ERROR, INSUFFICIENT_SCOPE, DRAFT_ONLY, NETWORK_NOT_AVAILABLE, NETWORK_MISMATCH, SCHEDULE_IN_FUTURE, IDEMPOTENCY_CONFLICT, IDEMPOTENCY_IN_PROGRESS, RATE_LIMITED, NOT_FOUND"},"requestId":{"type":"string"}}},"Connection":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"network":{"type":"string"},"name":{"type":"string"},"handle":{"type":["string","null"]},"agentAccess":{"type":"string","enum":["schedule","publish_with_confirmation","draft_only"]}}},"PostSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"network":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"}}},"Post":{"type":"object","properties":{"postId":{"type":"string","format":"uuid"},"status":{"type":"string"},"network":{"type":"string"},"scheduledAt":{"type":["string","null"],"format":"date-time"},"publishedAt":{"type":["string","null"],"format":"date-time"},"url":{"type":["string","null"]},"failure":{"type":["string","null"]}}}}},"paths":{"/v1/connections":{"get":{"summary":"List connected accounts and what the API can do with each","responses":{"200":{"description":"Connections","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"connections":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}}}}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute for this key","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"400":{"description":"Invalid input, a network agents can't use (NETWORK_NOT_AVAILABLE), or a draft over a network's text or media limits (DRAFT_INVALID)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed: INSUFFICIENT_SCOPE, DRAFT_ONLY, NETWORK_NOT_AVAILABLE, plan limit, suspended account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key reused with a different request, or still in progress","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited: 60 requests per minute per key, 120 per IP. Wait for Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"listConnections","description":"Needs the read scope."}},"/v1/posts":{"get":{"summary":"List the 100 most recent posts","parameters":[{"name":"status","in":"query","schema":{"type":"string","enum":["draft","ready","scheduled","publishing","retrying","published","failed","cancelled"]}}],"responses":{"200":{"description":"Posts","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"posts":{"type":"array","items":{"$ref":"#/components/schemas/PostSummary"}}}}}}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute for this key","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"400":{"description":"Invalid input, a network agents can't use (NETWORK_NOT_AVAILABLE), or a draft over a network's text or media limits (DRAFT_INVALID)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed: INSUFFICIENT_SCOPE, DRAFT_ONLY, NETWORK_NOT_AVAILABLE, plan limit, suspended account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key reused with a different request, or still in progress","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited: 60 requests per minute per key, 120 per IP. Wait for Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"listPosts","description":"Needs the read scope."},"post":{"summary":"Create a draft with one version per network","parameters":[{"name":"Idempotency-Key","in":"header","description":"Retry safely: the same key and body return the first result (24 hours for drafts); a different body returns 409.","schema":{"type":"string","minLength":8,"maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","text","networks"],"additionalProperties":false,"properties":{"title":{"type":"string","maxLength":200},"text":{"type":"string","maxLength":20000},"networks":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"string","enum":["instagram","threads","tiktok","pinterest","linkedin","x"]}},"mediaIds":{"type":"array","maxItems":10,"items":{"type":"string","format":"uuid"},"description":"Ready media assets of this workspace, in post order. Checked against each network's limits (X: 280 weighted characters, links count 23, up to 4 images of 5 MB or 1 MP4 video of 140 s; LinkedIn: 3,000 characters, up to 9 JPEG/PNG images of 5 MB or 1 MP4 video)."}}}}}},"responses":{"201":{"description":"Draft created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"versions":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string","format":"uuid"},"network":{"type":"string"},"aiGenerated":{"type":"boolean","const":true},"agentAccess":{"type":"string","enum":["draft_only"],"description":"LinkedIn and X versions only"},"approvalUrl":{"type":"string","format":"uri","description":"LinkedIn and X only. Opens the approval page in looktme for the signed-in person; the link alone never approves."},"approvalExpiresAt":{"type":"string","format":"date-time"},"next":{"type":"string"}}}}}}}}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute for this key","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"400":{"description":"Invalid input, a network agents can't use (NETWORK_NOT_AVAILABLE), or a draft over a network's text or media limits (DRAFT_INVALID)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed: INSUFFICIENT_SCOPE, DRAFT_ONLY, NETWORK_NOT_AVAILABLE, plan limit, suspended account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key reused with a different request, or still in progress","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited: 60 requests per minute per key, 120 per IP. Wait for Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"createDraft","description":"Needs the draft scope."}},"/v1/posts/{postId}":{"get":{"summary":"Get the status of one post","parameters":[{"name":"postId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Post","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Post"}}}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute for this key","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"400":{"description":"Invalid input, a network agents can't use (NETWORK_NOT_AVAILABLE), or a draft over a network's text or media limits (DRAFT_INVALID)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed: INSUFFICIENT_SCOPE, DRAFT_ONLY, NETWORK_NOT_AVAILABLE, plan limit, suspended account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found"},"409":{"description":"Idempotency-Key reused with a different request, or still in progress","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited: 60 requests per minute per key, 120 per IP. Wait for Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"getPost","description":"Needs the read scope."}},"/v1/drafts/{variantId}/schedule":{"post":{"summary":"Schedule a draft version on an account whose agentAccess is schedule","description":"Needs the schedule scope. Counts toward the plan's monthly post limit. Send an Idempotency-Key header when retrying.","parameters":[{"name":"variantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"Retry safely: the same key and body return the first result (24 hours for drafts); a different body returns 409.","schema":{"type":"string","minLength":8,"maxLength":120}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["connectionId","scheduledAt"],"additionalProperties":false,"properties":{"connectionId":{"type":"string","format":"uuid"},"scheduledAt":{"type":"string","format":"date-time","description":"At least 1 minute in the future"},"timezone":{"type":"string","default":"UTC"}}}}}},"responses":{"201":{"description":"Scheduled","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Post"}}}}},"headers":{"X-RateLimit-Limit":{"description":"Requests allowed per minute for this key","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in the current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time (seconds) when the window resets","schema":{"type":"integer"}}}},"400":{"description":"Invalid input, a network agents can't use (NETWORK_NOT_AVAILABLE), or a draft over a network's text or media limits (DRAFT_INVALID)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Not allowed: INSUFFICIENT_SCOPE, DRAFT_ONLY, NETWORK_NOT_AVAILABLE, plan limit, suspended account","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found"},"409":{"description":"Idempotency key reused for a different post"},"429":{"description":"Rate limited: 60 requests per minute per key, 120 per IP. Wait for Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"operationId":"schedulePost"}}}}