authed

Save a Slack agent's app credentials

Stores the Slack app's client ID and its two secrets, sealed; the app then awaits its install. Another app's credentials disconnect the app installed before them.

put/api/v1/agent-definitions/{definition_id}/slack-connection/credentials

Request

Base URL
https://api.teaflask.com (the document declares no server; this is the origin it was published from)
URL
https://api.teaflask.com/api/v1/agent-definitions/{definition_id}/slack-connection/credentials
Auth
none declared

Path parameters

definition_idstring uuid required

The agent's id, as list_agent_definitions returns it.

Request body

client_idstring required

The Slack app's client ID.

client_secretstring password required

The Slack app's client secret.

signing_secretstring password required

The Slack app's signing secret.

Response

Successful Response

availableboolean required

Whether this server can connect Slack agents at all.

status'awaiting_credentials' | 'awaiting_install' | 'installed' | 'uninstalled' | 'revoked' required

create_app_urlstring nullable required

The link that creates the agent's Slack app from its manifest.

manifest_jsonstring nullable required

The agent's Slack app manifest, as JSON.

client_idstring nullable required

The Slack app's client ID.

team_namestring nullable required

The Slack workspace the app is installed in.

bot_user_idstring nullable required

The app's bot user in Slack.

installed_atstring date-time nullable required

When the app was installed in Slack.

signature_troubleboolean required

Whether Slack's recent requests failed signature checks.

installed_from_slackboolean required

Whether the app was installed from Slack rather than here.

Changes

No recorded changes to this operation across all 1 revision of this API.