The Brief (formerly Creatopy) is an AI-powered advertising creation platform that helps brands and agencies discover, create, launch, and optimize ads at scale. Its Ad Studio, AI agents (Discover, Create, Optimize), and native ad server generate on-brand creatives, resize a single design into 50+ ad formats, publish directly to networks like Meta, Google Ads, CM360, DV360 and Veeva, and optimize campaign performance with data-backed recommendations. Founded in 2021 and based in Romania, The Brief is a portfolio company of Point Nine. It ships a documented Public API on two co-equal surfaces — a REST API at https://api.thebrief.ai/v1 and a single GraphQL endpoint at https://graphql.thebrief.ai/public whose 186-type schema is readable by anonymous introspection — covering designs and templates, brand kits, projects and folders, exports and creatives, ad serving and ad-tag reporting, team users and roles, credits, and team webhooks. Authentication is a JWT bearer token minted from a clientId/clientSecret pair; the same signed token powers the App Integration flow that embeds the Ad Studio editor inside a customer's own product. No OpenAPI is published.
TheBrief is listed with 3 APIs on the APIs.io network, including The Brief Public GraphQL API, and 2 more. Tagged areas include Company, Advertising, Creative, Design, and Artificial Intelligence.
The TheBrief catalog on APIs.io includes 1 event-driven AsyncAPI specification.
TheBrief’s developer surface includes engineering blog, pricing, support, getting-started guide, signup flow, documentation, API reference, and 25 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for
this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero:
never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and
several others — scorable at all.
The six quality facets above are damped to 85 points between them,
because the conditional facet above carries the other
15. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 85% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/thebrief/"><img src="https://apis.io/badge/thebrief/card.svg" alt="TheBrief on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Request/Response Examples+7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
The Brief's versioned REST API for creative automation — list and search designs, templates and brand templates, read a template's editable elements and size variants, submit ex...
A single POST GraphQL endpoint exposing the same data core as the REST API with arbitrary field selection — 48 queries and 49 mutations across designs, templates, brand kits, pr...
TheBrief API as documented publicly: 51 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.
aid: thebrief
name: TheBrief
description: The Brief (formerly Creatopy) is an AI-powered advertising creation platform that helps brands and agencies discover,
create, launch, and optimize ads at scale. Its Ad Studio, AI agents (Discover, Create, Optimize), and native ad server generate
on-brand creatives, resize a single design into 50+ ad formats, publish directly to networks like Meta, Google Ads, CM360,
DV360 and Veeva, and optimize campaign performance with data-backed recommendations. Founded in 2021 and based in Romania,
The Brief is a portfolio company of Point Nine. It ships a documented Public API on two co-equal surfaces — a REST API at
https://api.thebrief.ai/v1 and a single GraphQL endpoint at https://graphql.thebrief.ai/public whose 186-type schema is
readable by anonymous introspection — covering designs and templates, brand kits, projects and folders, exports and creatives,
ad serving and ad-tag reporting, team users and roles, credits, and team webhooks. Authentication is a JWT bearer token
minted from a clientId/clientSecret pair; the same signed token powers the App Integration flow that embeds the Ad Studio
editor inside a customer's own product. No OpenAPI is published.
url: https://raw.githubusercontent.com/api-evangelist/thebrief/refs/heads/main/apis.yml
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: false
label: Hosted service · you call their endpoint
confidence: medium
source:
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: paid
onboarding: self-service
trial: true
try_now: true
public: true
label: Self-service with free trial
confidence: high
source:
- https://www.thebrief.ai/pricing/
- https://docs.thebrief.ai/public-api
generated: '2026-08-12'
method: searched
note: 7-day free trial, no card required. Packaged tiers from $29/month; API-based bulk distribution is named as an Enterprise
contract feature and API credentials are minted in-app under Manage account > API credentials.
image: https://cdn.sanity.io/images/8wzdrx7x/production/d9d93597b665708876d106aed92e87d0addafc41-760x175.svg
x-type: company
x-source: vc-portfolio
x-backed-by:
- point-nine
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-08-12'
x-docs-platform: gitbook
x-docs-platform-confidence: high
x-docs-platform-checked: 2026-10-17
tags:
- Company
- Advertising
- Creative
- Design
- Artificial Intelligence
- Marketing
- Ad Serving
- Software-as-a-Service
- GraphQL
- Creative Automation
- Digital Asset Management
- Webhook
- Platform
tags_raw:
- Company
- Advertising
- Creative
- Design
- Artificial Intelligence
- Marketing
- Ad Serving
- SaaS
- GraphQL
- Creative Automation
- Digital Asset Management
- Webhooks
- AI
- Platform
apis:
- name: The Brief Public REST API
description: The Brief's versioned REST API for creative automation — list and search designs, templates and brand templates,
read a template's editable elements and size variants, submit exports with element changes and collect the rendered creatives,
manage projects, folders, brand kits (colors, fonts, logos, assets, media folders), team users and roles, share links,
design versions, credits and team webhooks, and drive The Brief's native ad server (enable/disable ad tags, update settings,
generate network code or CM360/DV360 CSV/XLSX trafficking files, and pull delivery reports). JWT bearer auth, cursor pagination,
a "response" envelope, and a published 15 req/10s (export) / 100 req/10s (everything else) per-team rate limit.
humanURL: https://docs.thebrief.ai/public-api/rest-api
baseURL: https://api.thebrief.ai/v1
tags:
- Advertising
- Creative Automation
- Ad Serving
- Design
properties:
- type: Documentation
url: https://docs.thebrief.ai/public-api/rest-api
- type: APIReference
url: https://docs.thebrief.ai/public-api/rest-api
- type: Authentication
url: authentication/thebrief-authentication.yml
- type: ErrorCatalog
url: errors/thebrief-error-codes.yml
- type: RateLimits
url: rate-limits/thebrief-rate-limits.yml
- type: Webhooks
url: asyncapi/thebrief-webhooks.yml
- name: The Brief Public GraphQL API
description: A single POST GraphQL endpoint exposing the same data core as the REST API with arbitrary field selection —
48 queries and 49 mutations across designs, templates, brand kits, projects, folders, exports and downloads, ad networks
and ad tags, A/B tests, comments, team users and roles, webhooks, credits and the Figma import pipeline. Anonymous __schema
introspection is open (verified HTTP 200, 2026-08-12); executing operations requires a JWT bearer token. Six fields carry
@deprecated directives with stated replacements — the only machine-readable deprecation signal The Brief publishes.
humanURL: https://docs.thebrief.ai/public-api/graphql
baseURL: https://graphql.thebrief.ai/public
tags:
- GraphQL
- Advertising
- Creative Automation
properties:
- type: GraphQL
url: graphql/thebrief-public.graphql
- type: Documentation
url: https://docs.thebrief.ai/public-api/graphql
- type: Authentication
url: authentication/thebrief-authentication.yml
- type: Postman
url: https://www.postman.com/thebrieftechnical/the-brief-api/collection/1lfct1g/graphql-api
- aid: thebrief:creatopy-com-api
name: TheBrief API
description: 'TheBrief API as documented publicly: 51 operations. Contract generated from the documentation by API Evangelist
(2026-10-29); not the provider''s own document.'
humanURL: https://docs.thebrief.ai/public-api/graphql/endpoints-and-queries.md
baseURL: https://api.thebrief.ai
properties:
- type: OpenAPI
url: openapi/_ae-authored/creatopy-com-openapi-generated.yml
x-provenance: generated
- type: JSONSchema
url: json-schema/creatopy-com-get-v1-credits-subscription-info-response-schema.json
- type: JSONSchema
url: json-schema/creatopy-com-get-v1-brandkit-brandkitid-assets-response-schema.json
- type: JSONSchema
url: json-schema/creatopy-com-post-v1-brandkit-uploadassets-response-schema.json
- type: JSONSchema
url: json-schema/creatopy-com-post-v1-brandkit-uploadlogos-response-schema.json
- type: JSONSchema
url: json-schema/creatopy-com-put-v1-folders-response-schema.json
- type: JSONSchema
url: json-schema/creatopy-com-get-v1-folders-response-schema.json
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
- FN: APIs.json
email: info@apis.io
common:
- type: TrustCenter
url: security/thebrief-trust-center.yml
- type: Compliance
url: https://www.thebrief.ai/security/
- type: DomainSecurity
url: security/thebrief-domain-security.yml
- type: Website
url: https://www.thebrief.ai
- type: Blog
url: https://www.thebrief.ai/blog/
- type: Pricing
url: https://www.thebrief.ai/pricing/
- type: Plans
url: plans/thebrief-plans-pricing.yml
- type: Support
url: https://help.thebrief.ai/
- type: GettingStarted
url: https://www.thebrief.ai/learning-hub/
- type: TermsOfService
url: https://www.thebrief.ai/legal-information/terms-of-use/
- type: PrivacyPolicy
url: https://www.thebrief.ai/legal-information/privacy-policy/
- type: GitHubOrganization
url: https://github.com/thebrief-ai
- type: Login
url: https://app.thebrief.ai/
- type: SignUp
url: https://app.thebrief.ai/auth/create-account
- type: LLMsTxt
url: llms/thebrief-llms.txt
- type: LLMsTxt
url: llms/thebrief-docs-llms.txt
- type: DeveloperPortal
url: https://docs.thebrief.ai/
- type: Documentation
url: https://docs.thebrief.ai/
- type: APIReference
url: https://docs.thebrief.ai/public-api
- type: Postman
url: https://www.postman.com/thebrieftechnical/the-brief-api/collection/1lfct1g/graphql-api
- type: GraphQL
url: graphql/thebrief-public.graphql
- type: Authentication
url: authentication/thebrief-authentication.yml
- type: Conventions
url: conventions/thebrief-conventions.yml
- type: ErrorCatalog
url: errors/thebrief-error-codes.yml
- type: RateLimits
url: rate-limits/thebrief-rate-limits.yml
- type: Webhooks
url: asyncapi/thebrief-webhooks.yml
- type: DataModel
url: data-model/thebrief-data-model.yml
- type: Lifecycle
url: lifecycle/thebrief-lifecycle.yml
- type: Deprecation
url: lifecycle/thebrief-lifecycle.yml
- type: Conformance
url: conformance/thebrief-conformance.yml
- type: Components
url: components/thebrief-components.yml
- type: AgentSkill
url: skills/_index.yml
x-enrichment:
date: '2026-08-12'
status: enriched
artifacts_added: 19
pass: local-v1
TheBrief API — frequently asked questions
Does TheBrief have an API?
Yes. APIs.io lists 3 APIs from TheBrief, including The Brief Public REST API, The Brief Public GraphQL API and TheBrief API.
Is there an OpenAPI specification for the TheBrief API?
Yes. APIs.io indexes 1 OpenAPI specification for TheBrief, each linked for download from this page.
How do I authenticate with the TheBrief API?
TheBrief uses bearer-token authentication (3 schemes). The details are profiled on APIs.io as Thebrief Authentication.
How much does the TheBrief API cost?
TheBrief publishes its prices; its Create Pro plan is $29/ month as of 2026-10-28. APIs.io lists 5 pricing plans for TheBrief, with each plan's price, limits and inclusions under Pricing on this page.
Is the TheBrief API ready for AI agents?
TheBrief has a Kin Score of 61.4 out of 100 (strong) and an Agent Readiness score of 26.1 (agent-aware), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: