Edit the draft - Sempera Docs

PATCH

agents

{agent_id}

draft

Edit the draft

curl --request PATCH \
  --url https://api.sempera.org/v1/agents/{agent_id}/draft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fields": {}
}'

import requests

url = "https://api.sempera.org/v1/agents/{agent_id}/draft"

payload = { "fields": {} }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({fields: {}})
};

fetch('https://api.sempera.org/v1/agents/{agent_id}/draft', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "agent_draft",
  "agent_id": "<string>",
  "revision": "<string>",
  "updated_at": "<string>",
  "by": "<string>",
  "fields": {},
  "warnings": [
    {
      "field": "<string>",
      "label": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ],
  "summary": "<unknown>",
  "editable_fields": "<unknown>",
  "result": "<unknown>"
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

Authorizations

Authorization

string

header

required

A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.

Path Parameters

agent_id

string

required

The agent's stable id.

Body

application/json

fields

object

required

Field key -> new value. Keys are the editor's field keys (editable_fields).

expect_revision

string

Refuse the save if the draft moved on.

Response

object

any

agent_id

string

revision

string | null

updated_at

string | null

fields

object

warnings

object[]

Advice about the draft's values as they stand, each naming its field (field, label, code, message). Never a refusal: the save and Publish go ahead. Today: an opening line that already says what Sempera adds after it (the AI disclosure, or the recording notice when calls are recorded), so callers would hear it twice.

Show child attributes

summary

any

editable_fields

any

result

any

⌘I

Edit the draft

curl --request PATCH \
  --url https://api.sempera.org/v1/agents/{agent_id}/draft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fields": {}
}'

import requests

url = "https://api.sempera.org/v1/agents/{agent_id}/draft"

payload = { "fields": {} }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({fields: {}})
};

fetch('https://api.sempera.org/v1/agents/{agent_id}/draft', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "agent_draft",
  "agent_id": "<string>",
  "revision": "<string>",
  "updated_at": "<string>",
  "by": "<string>",
  "fields": {},
  "warnings": [
    {
      "field": "<string>",
      "label": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ],
  "summary": "<unknown>",
  "editable_fields": "<unknown>",
  "result": "<unknown>"
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}

{
  "error": {
    "code": "AGENT_ENV_UNPINNED",
    "message": "<string>",
    "request_id": "<string>",
    "field": "<string>",
    "scope": "<string>",
    "reason": "<string>"
  }
}