Resolves the uppercase-normalized Task code within the token-scoped
Workspace. The revision field and the ETag header carry the
current revision that the revision-checked lifecycle operations
expect in If-Match. A Task the bearer cannot read is
indistinguishable from a missing one.
Path Parameters
task_codeRequired
string·min 4·max 28
Case-insensitive UI-equivalent Task code (PROJECT_KEY-TASK_NUMBER, for example PRO-123), normalized to uppercase before lookup.
Responses
ETag
string
Quoted decimal optimistic-concurrency version.
codeRequired
string·min 4·max 28
Case-insensitive client input normalized to uppercase by the server.
Exactly the UI ticket reference {PROJECT_KEY}-{TASK_NUMBER} (for
example PRO-123); the positive Task number is canonical decimal
without leading zeroes.
project_codeRequired
string·min 1·max 64
Case-insensitive client input normalized to uppercase by the server.
A code is unique across Projects, Tasks, and Documents in one
Workspace. Internal UUIDs are not a CLI identifier.
titleRequired
string·min 1·max 500
status_categoryRequired
string
Values
backlogtodoin_progressin_reviewdone
revisionRequired
integer·min 1
urlRequired
string <uri>
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
errorRequired
object
Retry-After
integer·min 0
Delay in seconds before retrying, when an expected maintenance end is known.
Cache-Control
string·const no-store
Prevents storage of error responses by clients and intermediaries.
X-Request-ID
string·min 1·max 200
Correlation identifier for the request.
X-Content-Type-Options
string·const nosniff
Prevents user agents from MIME-sniffing the response.
