Hướng dẫn AgentFlow

patch_record

PATCH/entities/{entity_id}/records/{record_id}

Values are validated against a schema synthesized from the live entity (entity_patch_schema), which routes them through the same type/option/ format assertions a bound form gets. Authorization is the same three tiers as the PUT: coarse entity.write/entity.read, object-level authorize_entity_mutation, and the command's record-level guard_record_mutate.

Authorization

AuthorizationBearer <token>

A service principal's credential, or a person's access token, AgentFlow's own or an installed app's. A service principal's effective permissions are its role permissions intersected with the credential's scopes.

In: header

Path Parameters

entity_id*string

Entity id

Formatuuid
record_id*string

Record id

Formatuuid

Header Parameters

Idempotency-Key?string

A key of 1 to 255 printable ASCII characters. Repeating this request with the same key returns the original outcome instead of performing it again. A UUID is recommended.

Length1 <= length <= 255

Request Body

application/json

changes keyed by entity field key, and expected_updated_at

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://example.com/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08/records/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "expected_updated_at": "2019-08-24T14:15:22Z"  }'
{  "body": {},  "created_at": "2019-08-24T14:15:22Z",  "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",  "entity_id": "8161163a-f227-466f-bc01-090a01e80165",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",  "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",  "unit_id": "5becc822-b69e-4e66-a762-ad8e868dcab6",  "updated_at": "2019-08-24T14:15:22Z",  "version": 0,  "file_counts": {    "property1": 0,    "property2": 0  },  "file_labels": {    "property1": {      "property1": "string",      "property2": "string"    },    "property2": {      "property1": "string",      "property2": "string"    }  },  "mentions": {    "property1": {      "href": "string",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "kind": "user",      "label": "string",      "state": "ok"    },    "property2": {      "href": "string",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "kind": "user",      "label": "string",      "state": "ok"    }  },  "ref_labels": {    "property1": {      "property1": "string",      "property2": "string"    },    "property2": {      "property1": "string",      "property2": "string"    }  },  "unit": null,  "visible_action_ids": [    "f379d2c9-fe6d-4ba6-bf32-0c26891f05a3"  ],  "unnotified": [    {      "name": "string",      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"    }  ]}