---
title: "POST /developer-apps"
method: POST
path: "/developer-apps"
tags: ["Control plane"]
---

# POST /developer-apps

`POST /developer-apps`

## Request

- Base URL: `https://api.team0.ai/v1`
- URL: `https://api.team0.ai/v1/developer-apps`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://clerk.team0.ai/oauth/authorize`, token URL `https://clerk.team0.ai/oauth/token`)
  - HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- DeveloperAppCreate
  - `name` string, required
  - `kind` 'oauth_public' | 'service', required: Confidential OAuth clients are not self-service in the first beta; server integrations use Team0 service credentials.
  - `redirect_uris` string[], required
  - `allowed_origins` string[], required
  - `maximum_execution_policy` 'caller_acts' | 'team0_asks_first' | 'team0_may_act': Maximum or effective action owner. A request may narrow an application's maximum but never widen it.

## Response `201`

Developer application created.

- DeveloperApp
  - `id` string, required
  - `object` 'developer_app', required
  - `name` string, required
  - `kind` 'oauth_public' | 'oauth_confidential' | 'service', required
  - `protocol_status` 'not_applicable' | 'pending' | 'ready' | 'mismatch' | 'disabled', required
  - `client_id` string, nullable: Clerk OAuth client ID for ready OAuth applications; never a client secret.
  - `redirect_uris` string[], required
  - `allowed_origins` string[], required
  - `maximum_execution_policy` 'caller_acts' | 'team0_asks_first' | 'team0_may_act', required: Maximum or effective action owner. A request may narrow an application's maximum but never widen it.
  - `version` integer, required
  - `created_at` string, date-time, required

## Other responses

- `202`: OAuth application accepted locally and awaiting Clerk protocol reconciliation.
- `default`: RFC 9457 problem response. Cross-tenant identity is non-enumerating.

---

[API](https://skmtc.dev/team0/apis/team0-external-api.md) · [All operations](https://skmtc.dev/team0/apis/team0-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/team0/apis/team0-external-api/revisions/9b838d20a98f?raw)