Delete
/team/list/{list_id}
Remove an existing team list
Security
HTTP
Type bearer
Bearer token authentication. Include the token in the Authorization header:
Authorization: Bearer <your-token>
Path parameters
list_id
stringRequired
Supermetrics team list ID
Max length50
Pattern^[A-Za-z0-9_-]+$
Responses
204
Team list removed successfully
Headers
Content-Type
string
HTTP response content type
Valid values[
"application/json"
]
Max length255
Exampleapplication/json
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example100
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example49
Access-Control-Allow-Origin
string
CORS header
Valid values[
"*"
]
Max length255
Example*
401
Unauthorized - invalid or missing authentication
Headers
Content-Type
string
HTTP response content type
Valid values[
"application/json"
]
Max length255
Exampleapplication/json
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example100
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example49
Access-Control-Allow-Origin
string
CORS header
Valid values[
"*"
]
Max length255
Example*
object
meta
object (ResponseMeta)
request_id
string
API request ID
Max length50
Pattern^[A-Za-z0-9_-]+$
error
object (Error)
code
string
Error code
Max length100
message
string
Error message
Max length255
description
string
Error description
Max length255
404
List Not Found
Headers
Content-Type
string
HTTP response content type
Valid values[
"application/json"
]
Max length255
Exampleapplication/json
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example100
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example49
Access-Control-Allow-Origin
string
CORS header
Valid values[
"*"
]
Max length255
Example*
object
error
string
Valid values[
"LIST_NOT_FOUND"
]
Max length100
message
string
Max length255
422
Unprocessable Entity - request validation failed
Headers
Content-Type
string
HTTP response content type
Valid values[
"application/json"
]
Max length255
Exampleapplication/json
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example100
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example49
Access-Control-Allow-Origin
string
CORS header
Valid values[
"*"
]
Max length255
Example*
object
meta
object (ResponseMeta)
request_id
string
API request ID
Max length50
Pattern^[A-Za-z0-9_-]+$
error
object (Error)
code
string
Error code
Max length100
message
string
Error message
Max length255
description
string
Error description
Max length255
429
Too Many Requests - rate limit exceeded
Headers
Content-Type
string
HTTP response content type
Valid values[
"application/json"
]
Max length255
Exampleapplication/json
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example100
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example49
Retry-After
integer
Number of seconds to wait before making another request
Minimum1
Maximum3600
Access-Control-Allow-Origin
string
CORS header
Valid values[
"*"
]
Max length255
Example*
object
meta
object (ResponseMeta)
request_id
string
API request ID
Max length50
Pattern^[A-Za-z0-9_-]+$
error
object (Error)
code
string
Error code
Max length100
message
string
Error message
Max length255
description
string
Error description
Max length255
500
List Update Failed
Headers
Content-Type
string
HTTP response content type
Valid values[
"application/json"
]
Max length255
Exampleapplication/json
X-RateLimit-Limit
integer
Request limit per hour
Minimum1
Maximum10000
Example100
X-RateLimit-Remaining
integer
Remaining requests in current window
Minimum0
Maximum10000
Example49
Access-Control-Allow-Origin
string
CORS header
Valid values[
"*"
]
Max length255
Example*
object
error
string
Valid values[
"LIST_UPDATE_FAILED"
]
Max length100
message
string
Max length255