# API reference (/docs/api/reference)



The full Partner API surface — seventeen resources, every endpoint documented. Hit [`GET /v1/whoami`](/docs/api/reference/organizations/whoami) first to confirm your key's org and rate-limit tier, then work down to the resource you need.

<Cards>
  <Card title="Organizations" href="/docs/api/reference/organizations" description="Key-scoped org identity. Read-only." />

  <Card title="Projects" href="/docs/api/reference/projects" description="Create, list, patch, archive per-customer projects." />

  <Card title="GitHub" href="/docs/api/reference/github" description="Register an installation, ingest a repo." />

  <Card title="SDK apps" href="/docs/api/reference/sdk-apps" description="Create SDK apps and fetch install specs." />

  <Card title="Media" href="/docs/api/reference/media" description="Presign uploads, finalize, reference media in content." />

  <Card title="Telemetry" href="/docs/api/reference/telemetry" description="SDK events, conversions, Apple Ads attribution." />

  <Card title="Influencers" href="/docs/api/reference/influencers" description="Manage influencer personas per project." />

  <Card title="Content" href="/docs/api/reference/content" description="Generate, regenerate, clone, list content items." />

  <Card title="Approval" href="/docs/api/reference/approval" description="Policy, queue, approve or reject content." />

  <Card title="Social accounts" href="/docs/api/reference/social-accounts" description="Connect accounts, check OAuth status, revoke." />

  <Card title="Publishing" href="/docs/api/reference/publishing" description="Schedule and publish to connected accounts." />

  <Card title="Leased accounts" href="/docs/api/reference/leased-accounts" description="Request Layers-operated accounts for a niche." />

  <Card title="Engagement" href="/docs/api/reference/engagement" description="Auto-pilot replies, DMs, comment handling." />

  <Card title="Metrics" href="/docs/api/reference/metrics" description="Organic and ads performance queries." />

  <Card title="Ads" href="/docs/api/reference/ads" description="Read ad campaign state, spend, and status." />

  <Card title="Recommendations" href="/docs/api/reference/recommendations" description="Server-side picks for what to generate next." />

  <Card title="Jobs" href="/docs/api/reference/jobs" description="The unified async envelope — poll /v1/jobs/:id." />

  <Card title="Webhooks" href="/docs/api/reference/webhooks/list-endpoints" description="HMAC-signed event delivery — register endpoints, rotate secrets, replay deliveries." />
</Cards>

## Conventions [#conventions]

Every page uses the same shape: an `<Endpoint>` block with method, path, auth, and phase; a `Parameters` table; request examples in curl, TypeScript, and Python; a response block; and a stable error table. See [errors](/docs/api/operational/errors), [rate limits](/docs/api/operational/rate-limits), and [idempotency](/docs/api/operational/idempotency) for cross-cutting behavior every endpoint inherits.

All examples use `X-Api-Key: $LAYERS_API_KEY` for auth. `Authorization: Bearer $LAYERS_API_KEY` is accepted as a fallback.