Skip to main content
POST
/
v3
/
organizations
/
{org_id}
/
secrets
Create an org-level secret
curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/secrets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "value": "<string>",
  "is_sensitive": true,
  "note": "<string>"
}
'
{
  "created_at": 123,
  "created_by": "<string>",
  "is_sensitive": true,
  "key": "<string>",
  "note": "<string>",
  "secret_id": "<string>",
  "updated_at": 123,
  "updated_by": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Permissions

Requires a service user with the ManageOrgSecrets permission at the organization level.

Authorizations

​
Authorization
string
header
required

Service User credential (prefix: cog_)

Body

application/json
​
key
string
required
​
type
enum<string>
required
Available options:
cookie,
key-value,
totp
​
value
string
required
​
is_sensitive
boolean
default:true
​
note
string | null

Response

Successful Response

​
access_type
enum<string>
required
Available options:
org,
personal
​
created_at
integer
required
​
created_by
string
required
​
is_sensitive
boolean
required
​
key
string | null
required
​
note
string | null
required
​
secret_id
string
required
​
secret_type
enum<string>
required
Available options:
cookie,
key-value,
totp
​
updated_at
integer | null
​
updated_by
string | null