Skip to content
Athena User Guide
Esc
↑↓navigate↵open⌘Jpreview

Enable a service; refused once the host is allocated or the network opens

POST/api/admin/services/{id}/enable
Authorization
AuthorizationBearer token · headerrequired
Path parameters
idstringrequired
min length 1
Responses
200

Success

idstringrequired
numbernumberrequired
slugstringrequired
namestringrequired
descriptionstringrequired
imagestringrequired
imageDigeststringrequired
checkerImagestringrequired
checkerImageDigeststringrequired
pullUsernamestring | nullrequired
Show properties
Any of:
string
string
null
null
portsobject[]required
Show properties
Array of object
portnumberrequired
protocolstringrequired
Show properties
Any of:
string
string
string
string
checkerTimeoutSecondsnumber | nullrequired
Show properties
Any of:
number
number
null
null
enabledbooleanrequired
positionnumberrequired
sourceFileIdstring | nullrequired
Show properties
Any of:
string
string
null
null
createdBystring | nullrequired
Show properties
Any of:
string
string
null
null
createdAtstring<date-time>required
updatedAtstring<date-time>required
pullCredentialsSetbooleanrequired
401

Unauthorized

errorstringrequired
404

Response for status 404

errorstringrequired
409

Response for status 409

errorstringrequired
422

Validation failed

typestringrequired
onstringrequired
summarystring
messagestring
foundany
propertystring
expectedstring
500

Unhandled server error

errorstringrequired
Try it
Server
Authorization
Parameters
Request
curl -X POST '/api/admin/services/string/enable' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "id": "string",
  "number": 0,
  "slug": "string",
  "name": "string",
  "description": "string",
  "image": "string",
  "imageDigest": "string",
  "checkerImage": "string",
  "checkerImageDigest": "string",
  "pullUsername": "string",
  "ports": [
    {
      "port": 0,
      "protocol": "tcp"
    }
  ],
  "checkerTimeoutSeconds": 0,
  "enabled": true,
  "position": 0,
  "sourceFileId": "string",
  "createdBy": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "pullCredentialsSet": true
}