Facebook Developers
DocsToolsSupportNewsApps
Log In
  • Social Plugins
  • Facebook Login
  • Open Graph
  • Facebook APIs
    • Graph API
    • FQL
    • Open Graph
    • Dialogs
    • Chat
    • Internationalization
    • Ads
  • Games
  • Payments
  • App Center
  • Promote Your App
  • iOS
  • Android
  • JavaScript
  • PHP
  • More SDKs
  • Objects
    • Achievement(Instance)
    • Album
    • Application
    • Checkin
    • Comment
    • Domain
    • Errors
    • Event
    • Field Expansion
    • FriendList
    • Group
    • Insights
    • Link
    • Message
    • Note
    • Offer
    • Order
    • Page
    • Pagination
    • Payment
    • Photo
    • Pictures
    • Post
    • Privacy Parameter
    • Publishing
    • Question
    • QuestionOption
    • Realtime Updates
    • Review
    • Search
    • Selecting Results
    • Status message
    • Thread
    • User
    • Video

Status message

Facebook APIs › Graph API › Status message

A status message on a user's wall as represented in the Graph API.

Example

A status message on the Facebook Page:

https://graph.facebook.com/10150224661566729


Fields

A Status message has the following fields.

NameDescriptionPermissionsReturns
id

The status message ID

Requires access_token

string

from

The user who posted the message

Requires access_token

object containing id and name fields

message

The status message content

Requires access_token

string

place

Location associated with a Status, if any

Requires access_token

object containing id and name of Page associated with this location, and a location field containing geographic information such as latitude, longitude, country, and other fields (fields will vary based on geography and availability of information)

updated_time

The time the message was published

Requires access_token

string containing ISO-8601 date-time

type

The object type which is set to status

Requires access_token

string

Update

You cannot edit any of the fields in the status message object.


Connections

A Status message has the following connections.

NameDescriptionPermissionsReturns
comments

All of the comments on this message

Requires access_token

array of objects containing id, from, message and created_time fields

likes

The users that have liked this message

Requires access_token

array of objects containing id and name

comments

Create

You can write to the STATUS_MESSAGE_ID/comments connection to post a comment to the status message by issuing an HTTP POST request with the publish_stream permission and following parameters.

Parameter Description Type Required
message Comment text string yes

If the write is successful, you get the following return.

Name Description Type
id The new comment ID string

likes

Create

You can write to the STATUS_MESSAGE_ID/likes connection to like the status message by issuing an HTTP POST request with the publish_stream permission. No parameters necessary.

If the write is successful, you get the following return.

Description Type
If the like succeeded boolean

Delete

You can unlike an status message by issuing an HTTP DELETE request to the STATUS_MESSAGE_ID/likes connection with the publish_stream permission.

If the delete is successful, you get the following return.

Description Type
If the unlike succeeded boolean
Updated over a year ago
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy