---
title: "Changes to Create an agent"
method: POST
path: "/agent/identities"
---

# Changes to Create an agent

`POST /agent/identities`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 9 revisions.

- **2026-10-19** `2c45dcc0a13e`: 15 breaking, 1 warning, 9 info
- **2026-09-09** `4a13a21e49d9`: 1 info
- **2026-08-15** `a0daf9e59774`: 1 breaking, 1 warning, 24 info

## Changes

- **2026-10-19** `2c45dcc0a13e`: 15 breaking, 1 warning, 9 info
  - the request property `base_harness` became not nullable
  - the request property `base_model` became not nullable
  - the request property `credential_strategy` became not nullable
  - the request property `default_runner_uid` became not nullable
  - the request property `description` became not nullable
  - the request property `environment_id` became not nullable
  - the request property `prompt` became not nullable
  - the request property `worker_host` became not nullable
  - removed the enum value `claude` of the request property `harness/allOf[#/components/schemas/Harness]/type`
  - removed the enum value `codex` of the request property `harness/allOf[#/components/schemas/Harness]/type`
  - removed the enum value `gemini` of the request property `harness/allOf[#/components/schemas/Harness]/type`
  - removed the enum value `oz` of the request property `harness/allOf[#/components/schemas/Harness]/type`
  - the `harness/allOf[#/components/schemas/Harness]/type` request property type changed from `string` to no type
  - added `#/components/schemas/ExternalHarness, subschema #1` to the `harness/allOf[#/components/schemas/Harness]/type` response property `oneOf` list for the response status `201`
  - the `harness/allOf[#/components/schemas/Harness]/type` response's property type changed from `string` to no type for status `201`
  - removed `#/components/schemas/AgentCredentialStrategy` from the `credential_strategy` request property `allOf` list
  - added the new optional request property `harness_auth_secrets/allOf[#/components/schemas/HarnessAuthSecrets]/pi_auth_secret_name`
  - added `#/components/schemas/AgentCredentialStrategy, subschema #2` to the `credential_strategy` request property `oneOf` list
  - added `#/components/schemas/ExternalHarness, subschema #1` to the `harness/allOf[#/components/schemas/Harness]/type` request property `oneOf` list
  - added the optional property `harness_auth_secrets/allOf[#/components/schemas/HarnessAuthSecrets]/pi_auth_secret_name` to the response with the `201` status
  - added the optional property `inference_providers/allOf[#/components/schemas/InferenceProvidersConfig]/aws/role_arn_source` to the response with the `201` status
  - removed the `claude` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `201`
  - removed the `codex` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `201`
  - removed the `gemini` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `201`
  - removed the `oz` enum value from the `harness/allOf[#/components/schemas/Harness]/type` response property for the response status `201`
- **2026-09-09** `4a13a21e49d9`: 1 info
  - added the new optional `header` request parameter `X-Warp-Team-Uid`
- **2026-08-15** `a0daf9e59774`: 1 breaking, 1 warning, 24 info
  - removed the required property `memory_stores` from the response with the `201` status
  - removed the request property `memory_stores`
  - added the new optional request property `credential_strategy`
  - added the new optional request property `default_runner_uid`
  - added the new optional request property `harness`
  - added the new optional request property `mcp_servers`
  - added the new optional request property `memory`
  - added the new optional request property `on_behalf_of_enabled`
  - added the new optional request property `worker_host`
  - request property `base_harness` deprecated
  - added the optional property `auth_url` to the response with the `400` status
  - added the optional property `auth_url` to the response with the `401` status
  - added the optional property `auth_url` to the response with the `403` status
  - added the optional property `auth_url` to the response with the `500` status
  - added the optional property `credential_strategy` to the response with the `201` status
  - added the optional property `harness` to the response with the `201` status
  - added the optional property `mcp_servers` to the response with the `201` status
  - added the optional property `on_behalf_of_enabled` to the response with the `201` status
  - added the optional property `provider` to the response with the `400` status
  - added the optional property `provider` to the response with the `401` status
  - added the optional property `provider` to the response with the `403` status
  - added the optional property `provider` to the response with the `500` status
  - added the optional property `worker_host` to the response with the `201` status
  - response property `base_harness` deprecated
  - added the required property `default_runner_uid` to the response with the `201` status
  - added the required property `memory` to the response with the `201` status

---

[Operation](https://skmtc.dev/warp/apis/oz-agent-api/docs/agent/identities/post.md) - [API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [Page](https://skmtc.dev/warp/apis/oz-agent-api/changes/agent/identities/post)