Podio API Documentation

Items

Items are entries in an app. If you think of app as a table, items will be the rows in the table. Items consists of some basic information as well values for each of the fields in the app. For each field there can be multiple values (F.ex. there can be multiple links to another app) and multiple types of values (F.ex. a field of type date field consists of both a start date and an optional end date). The type is denoted by an string id called a sub_id. Most types of fields have only one type, which is denoted by the sub_id values. Others have multiple sub_ids. The sub_ids and their values are listed for each field below:

  • embed
    • embed: The id of an embed returned from the Add an embed operation.
    • file: The id of one the thumbnail files returned from the same operation.
  • duration
    • value: The duration in seconds
  • video
    • value: The file id of the video file
  • location
    • value: The location as entered by the user
    • formatted: The resolved formatted full address
    • street_number: The number in the street
    • street_name: The name of the street
    • postal_code: The zip code for the city
    • city: The name of the city
    • state: The state of the city, if any
    • country: The country of the city
    • lat: The latitude of the location
    • lng: The longitude of the location
  • progress
    • value: The current progress as an integer from 0 to 100
  • money
    • value: The decimal amount of the value as a string.
    • currency: The currency of the value.  
  • contact:
    • value: The profile id of the contact
  • member
    • value: The user id of the member
  • app
    • value: The id of the app item
  • date
    • start_date: The start date
    • start_time: The start time
    • end_date: The end date
    • end_time: The end time
  • image:
    • value: The file id of the image file
  • number:
    • value: The decimal value of the field as a string.
  • text:
    • value: The value of the field which can be any length.
    • format: The format of the text, either plain, markdown or html
  • category
    • value: The id of the option
  • email:
    • value: Text value (max 254 characters)
    • type: "home"/"work"/"other"
  • phone:

    • type: "mobile"/"work"/"home"/"main"/"work_fax"/"private_fax"/ "other"
    • value: string value  (max 50 characters)

 

When creating, updating and deleting fields it can be easier to create/update/delete values for each field individually (or even for each sub_id individually).

Items can have comments and ratings. To add ratings or comments, use the corresponding area.