Test And Accept Docs

Open Test And Accept

Reorder user stories

Update the order of multiple user stories

PUT

https://api.testandaccept.com/api/rest/user-stories/reorder

Authorization

bearerAuth
HTTP Bearer (tnda_ token)
required

Request body JSON required

storyUpdates
array of
object
required
- id
  string
  required
  format: uuid · pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$
- orderIndex
  integer
  required
  maximum: 9007199254740991 · minimum: 0
}

Returns

200

Successful response

JSON

success
boolean
required

400

Invalid input data

JSON

message
string
required
The error message
code
string
required
The error code
issues
optional
array of
object
An array of issues that were responsible for the error
- message
  string
  required
}

401

Authorization not provided

JSON

message
string
required
The error message
code
string
required
The error code
issues
optional
array of
object
An array of issues that were responsible for the error
- message
  string
  required
}

403

Insufficient access

JSON

message
string
required
The error message
code
string
required
The error code
issues
optional
array of
object
An array of issues that were responsible for the error
- message
  string
  required
}

404

Not found

JSON

message
string
required
The error message
code
string
required
The error code
issues
optional
array of
object
An array of issues that were responsible for the error
- message
  string
  required
}

500

Internal server error

JSON

message
string
required
The error message
code
string
required
The error code
issues
optional
array of
object
An array of issues that were responsible for the error
- message
  string
  required
}

Reorder user stories

curl --request PUT \
  --url https://api.testandaccept.com/api/rest/user-stories/reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "storyUpdates": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "orderIndex": 0
    }
  ]
}
'

const url = 'https://api.testandaccept.com/api/rest/user-stories/reorder';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({storyUpdates: [{id: '497f6eca-6276-4993-bfeb-53cbbbba6f08', orderIndex: 0}]})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.testandaccept.com/api/rest/user-stories/reorder"

payload = { "storyUpdates": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "orderIndex": 0
        }
    ] }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

Response example

{
  "success": true
}

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}