Get model details or invocation status

GET 
/ai/models/:model_id

Two distinct reads on the same path, selected by the action query parameter. The two modes return different fields; both are described by AIModelDetails. action=get_details (the default when action is omitted) returns the model's metadata: identity, status, parameters, modalities, supported inference types, adaptive-thinking capability, the Amorphic components the model is allow-listed for, and its cost tags. AdaptiveThinking is always present as a boolean. Effort is always present (an empty array for models without adaptive thinking). CostTags is always present and is an empty array when cost management is disabled for the environment. action=invoke returns the state of a single asynchronous invocation started by POST /ai/models/{model_id} and requires invocation_id. It returns UserInput, InvocationStatus, and InvocationTime, plus ModelResponse once the invocation has completed. No model metadata is returned in this mode. Poll until InvocationStatus is no longer IN_PROGRESS. Invocation records expire 30 days after creation; after that, lookup fails as an invalid invocation id.

Any other action value returns GE-1010 as a 400.

Request

Responses

200

Model metadata when action=get_details, or invocation state when action=invoke. ModelResponse is present only once the invocation has completed successfully.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Input validation failure. Body is {"Message": " - "}. Codes: IPV-1001 (invocation_id missing when action=invoke), IPV-1002 (invocation_id unknown, expired, or belonging to a different model), GE-1010 (action value is not get_details or invoke). AUTH-1014 from the role check is also returned here, not as a 403.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Codes: IPV-1002 (unknown model_id with action=get_details — returned as 500, not 404), DB-1001 (invocation lookup failed), GE-1008 (catch-all).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers