Get a story

GET

/api/stories/{storyId}

curl --request GET \
  --url http://localhost:3001/api/stories/example \
  --header 'Authorization: <Authorization>'

• Local development
• Production

Retrieve a specific story by ID if the user has permission to view it

Authorizations

• BearerAuth

Parameters

Path Parameters

storyId

required

string

Story ID

Responses

200

OK

Media typeapplication/json

object

message

string

story

object

avatar_chunk_id

Owner avatar

integer

content

Caption/text

string

created_at

Unix timestamp

integer

duration

Video duration in ms

integer

expires_at

Unix timestamp

integer

first_name

Owner first name

string

has_viewed

Whether current user viewed it

boolean

height

Media height

integer

id

Story ID (hex)

string

is_own

Whether story belongs to current user

boolean

last_name

Owner last name

string

media_chunk_id

MeshStorage chunk ID for media

integer

media_type

“image” or “video”

string

privacy_level

“all”, “contacts”, “custom”

string

reply_count

Number of replies

integer

user_address

Story owner address

string

username

Owner username

string

view_count

Number of views

integer

width

Media width

integer

success

boolean

Example^generated

{
  "message": "example",
  "story": {
    "avatar_chunk_id": 1,
    "content": "example",
    "created_at": 1,
    "duration": 1,
    "expires_at": 1,
    "first_name": "example",
    "has_viewed": true,
    "height": 1,
    "id": "example",
    "is_own": true,
    "last_name": "example",
    "media_chunk_id": 1,
    "media_type": "example",
    "privacy_level": "example",
    "reply_count": 1,
    "user_address": "example",
    "username": "example",
    "view_count": 1,
    "width": 1
  },
  "success": true
}

400

Bad Request

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

401

Unauthorized

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

404

Not Found

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}