---
layout: default
navsection: api
navmenu: API Methods
title: "api_clients"

...

See "REST methods for working with Arvados resources":{{site.baseurl}}/api/methods.html

API endpoint base: @https://{{ site.arvados_api_host }}/arvados/v1/api_clients@

UUID type: @ozdt8@

Required arguments are displayed in %{background:#ccffcc}green%.

h2. Resource

The "api_clients" resource determines if web applications that have gone through the browser login flow may create or list API tokens.

Each ApiClient has, in addition to the usual "attributes of Arvados resources":{{site.baseurl}}/api/resources.html:

table(table table-bordered table-condensed).
|_. Attribute|_. Type|_. Description|_. Example|
|name|string|||
|url_prefix|string|||
|is_trusted|boolean|Trusted by users to handle their API tokens (ApiClientAuthorizations).||

h2. Methods

h3. create

Create a new ApiClient.

Arguments:

table(table table-bordered table-condensed).
|_. Argument |_. Type |_. Description |_. Location |_. Example |
|api_client|object||query||

h3. delete

Delete an existing ApiClient.

Arguments:

table(table table-bordered table-condensed).
|_. Argument |_. Type |_. Description |_. Location |_. Example |
{background:#ccffcc}.|uuid|string|The UUID of the ApiClient in question.|path||

h3. get

Gets a ApiClient's metadata by UUID.

Arguments:

table(table table-bordered table-condensed).
|_. Argument |_. Type |_. Description |_. Location |_. Example |
{background:#ccffcc}.|uuid|string|The UUID of the ApiClient in question.|path||

h3. list

List api_clients.

Arguments:

table(table table-bordered table-condensed).
|_. Argument |_. Type |_. Description |_. Location |_. Example |
|limit|integer (default 100)|Maximum number of api_clients to return.|query||
|order|string|Order in which to return matching api_clients.|query||
|filters|array|Conditions for filtering api_clients.|query||

h3. update

Update attributes of an existing ApiClient.

Arguments:

table(table table-bordered table-condensed).
|_. Argument |_. Type |_. Description |_. Location |_. Example |
{background:#ccffcc}.|uuid|string|The UUID of the ApiClient in question.|path||
|api_client|object||query||