API keys on Agentset allow you to access your workspace programmatically. This is useful for integrating Agentset into your application or with other tools and services.

Each API key is tied to a specific workspace – meaning you can use it to access that workspace’s resources without having to worry about “leaking” access to other workspaces.

API keys on Agentset follow the format:

.env
AGENTSET_API_KEY=agentset_xxxxxxxx

By default, you can use this key to perform any API request without restriction, so it must be stored securely in your app’s server-side code (such as in an environment variable or credential management system). Don’t expose this key on a website.

​
Create an API key

You can create an API key by following these steps:

1

Go to your workspace

Go to Settings > API Keys in your workspace.

2

Create an API Key

Click on the “Create” button and select permissions you want to grant to the API key.

Select between “You” and “Machine” to associate the API key with your account or a machine user.

  • You: This API key is tied to your user and can make requests against the selected workspace.
  • Machine: A machine user will be added to your workspace, and an API key associated with that machine user will be created.

Click on the Create API Key button to create the key. Make sure to copy your API key and store it in a safe place. You won’t be able to see it again.

3

Use your API Key

Now that you have your API key, you can use it to access your workspace’s resources programmatically via SDKs or within any API request as a bearer token.

Authorization: Bearer agentset_xxxx

We recommend creating API keys with the least privilege necessary to perform the required tasks. This helps to reduce the risk of unauthorized access to your workspace.