Content-Type header to interpret request bodies and Accept to select a response representation. Send both headers even when an operation currently documents only one representation; individual resources may support additional representations over time.
Common representations
Most documented Agent API operations use
POST with JSON. Follow the generated operation’s request body instead of assuming every resource accepts every media type.
JSON request
{} when its request body is required.
Binary and attachment data
Some operations represent attachment or binary content inside their documented JSON or XML request. Do not assume a generic/files endpoint or multipart/form-data contract. Use the exact request schema and encoding documented for that operation.
Content negotiation failures
400 Bad Requestcan indicate that the body does not match the operation’s schema.406 Not Acceptablecan indicate that the requested response representation is unsupported.415 Unsupported Media Typemay be returned by HTTP infrastructure when the request representation is unsupported; confirm the deployed behavior before depending on it.