Get a signed view URL for a card file

GET

/boards/{board}/cards/{card}/files/{file}/view

const url = 'https://projects.work.optidata.cloud/api/boards/1/cards/1/files/example/view';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://projects.work.optidata.cloud/api/boards/1/cards/1/files/example/view \
  --header 'Authorization: Bearer <token>'

Returns a short-lived signed URL that renders the file in the Optiwork Drive viewer.

Authorizations

bearerAuth

Parameters

Path Parameters

board

required

integer

Board id.

card

required

integer

Card id (must belong to the board).

file

required

string

File identifier (opaque string, not the numeric id).

Responses

200

Signed viewer URL.

application/json

object

url

string format: uri

Example

{
  "url": "https://drive.work.optidata.cloud/view/abc123?signature=..."
}

401

Missing, invalid or expired bearer passport.

application/json

object

error

string

Example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The authenticated user lacks the required board permission.

application/json

object

message

string

Example

{
  "message": "This action is unauthorized."
}

404

Resource not found, or a nested resource does not belong to its parent in the path.

application/json

object

message

string

Example

{
  "message": "Not found."
}