evroc Think Models API

API for managing AI model instances on the evroc Think platform

Version: v1beta1

Contact information: evroc Support https://www.evroc.com/ support@evroc.com

Security

BearerAuth

apiKey	API Key
Description	Bearer token for authentication (format: Bearer )
In	header
Name	Authorization

OrganizationHeader

apiKey	API Key
Description	Organization identifier header
In	header
Name	organization

/

GET

Summary:

Test endpoint

Description:

Just a test endpoint. Says hello.

Responses

Code	Description	Schema
200	OK	string

/instances

GET

Summary:

List model instances

Description:

Retrieve all model instances belonging to the authenticated organization

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string

Responses

Code	Description	Schema
200	List of model instances	[ v1beta1.ListInstancesResponse ]
401	Unauthorized - authentication required	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

POST

Summary:

Create model instance

Description:

Deploy a new model instance with specified configuration

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string
instance	body	Model instance configuration	Yes	v1beta1.InstanceCreateRequest

Responses

Code	Description	Schema
201	Model instance created successfully	v1beta1.CreateInstanceResponse
400	Invalid request - missing or invalid parameters	v1beta1.ErrorResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
403	Forbidden - model or size not allowed for organization	v1beta1.ErrorResponse
409	Conflict - instance with same name already exists	v1beta1.ErrorResponse
429	Too Many Requests - quota exceeded for selected size	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
OrganizationHeader
BearerAuth
OrganizationHeader

/instances/

DELETE

Summary:

Delete model instance

Description:

Delete model instance

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string
name	path	Name of the model instance to delete	Yes	string

Responses

Code	Description	Schema
202	Deletion initiated successfully	object
400	Invalid request - missing instance name	v1beta1.ErrorResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
404	Model instance not found	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

PUT

Summary:

Update model instance

Description:

Update configuration of an existing model instance. Note that changing the model is not allowed - delete and recreate instead.

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string
name	path	Name of the model instance to update	Yes	string
instance	body	Updated model instance configuration. You can only change size, args and env vars	Yes	v1beta1.InstanceUpdateRequest

Responses

Code	Description	Schema
202	Update accepted and processing	object
400	Invalid request - name mismatch or invalid parameters	v1beta1.ErrorResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
403	Forbidden - cannot change model or size not allowed	v1beta1.ErrorResponse
404	Model instance not found	v1beta1.ErrorResponse
429	Too Many Requests - not enough resources for new size	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

/instances/{name}/start

GET

Summary:

Start model instance

Description:

Start a stopped model instance to resume serving requests

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string
name	path	Name of the model instance to start	Yes	string

Responses

Code	Description	Schema
202	Start request accepted and processing	object
400	Invalid request - missing instance name	v1beta1.ErrorResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
404	Model instance not found	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

/instances/{name}/stop

GET

Summary:

Stop model instance

Description:

Stop a running model instance to save resources while preserving configuration

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string
name	path	Name of the model instance to stop	Yes	string

Responses

Code	Description	Schema
202	Stop request accepted and processing	object
400	Invalid request - missing instance name	v1beta1.ErrorResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
404	Model instance not found	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

/logs/

GET

Summary:

Get instance logs

Description:

Retrieve logs for a specific model instance

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string
name	path	Name of the model instance	Yes	string

Responses

Code	Description	Schema
200	Returns logs of the pod as array of log lines	[ string ]
400	Invalid request - missing instance name	v1beta1.ErrorResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
404	Model instance not found	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

/models

GET

Summary:

Get all models

Description:

Retrieve a list of all available models with their specifications

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string

Responses

Code	Description	Schema
200	Returns map of models with the model's respective specifications	v1beta1.ListModelsResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

/models/

GET

Summary:

Get model details

Description:

Retrieve detailed information about a specific model

Parameters

Name	Located in	Description	Required	Schema
model	path	Model handle (e.g., 'microsoft/DialoGPT-medium', 'meta-llama/Llama-2-7b-hf')	Yes	string
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string

Responses

Code	Description	Schema
200	Model specification	v1beta1.ModelSpec
401	Unauthorized - authentication required	v1beta1.ErrorResponse
404	Model not found	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

/sizes

GET

Summary:

Get all sizes

Description:

Retrieve a list of all available compute sizes with their resource specifications

Parameters

Name	Located in	Description	Required	Schema
Authorization	header	Bearer token for authentication	Yes	string
organization	header	Organization identifier	Yes	string

Responses

Code	Description	Schema
200	Map of size names to their specifications	v1beta1.ListSizesResponse
401	Unauthorized - authentication required	v1beta1.ErrorResponse
500	Internal server error	v1beta1.ErrorResponse

Security

Security Schema	Scopes
BearerAuth
OrganizationHeader

Models

v1beta1.CreateInstanceResponse

Name	Type	Description	Required
instance	v1beta1.Instance		No
message	string		No

v1beta1.ErrorResponse

Name	Type	Description	Required
details	object		No
error	string		No

v1beta1.Instance

Name	Type	Required
arguments	[ string ]	No
created_at	string	No
endpoint	string	No
environment	object	No
model	string	No
name	string	No
organization	string	No
size	string	No
status	v1beta1.InstanceStatus	No
stopped	boolean	No
token	string	No
updated_at	string	No

v1beta1.InstanceCreateRequest

Name	Type	Required
arguments	[ string ]	No
environment	object	No
model	string	No
name	string	No
size	string	No
stopped	boolean	No
token	string	No

v1beta1.InstanceStatus

Name	Type	Required
error_count	integer	No
last_error	string	No
last_updated	string	No
message	string	No
phase	string	No
ready	boolean	No
ready_replicas	integer	No

v1beta1.InstanceUpdateRequest

Name	Type	Required
arguments	[ string ]	No
environment	object	No
name	string	No
size	string	No
token	string	No

v1beta1.ListInstancesResponse

Name	Type	Description	Required
instances	object		No

v1beta1.ListModelsResponse

Name	Type	Description	Required
models	object		No

v1beta1.ListSizesResponse

Name	Type	Description	Required
sizes	object		No

v1beta1.ModelSpec

Name	Type	Required
default_args	[ string ]	No
default_env	object	No
description	string	No
handle	string	No
instance_type	string	No
license	string	No
license_url	string	No

v1beta1.SizeSpec

Name	Type	Required
cpu	string	No
description	string	No
gpu	string	No
labels	object	No
memory	string	No
name	string	No

evroc User Documentation

/instances/

/logs/

/models/