geekbot.com Open in urlscan Pro
161.35.32.116  Public Scan

Form analysis
0 forms found in the DOM

Text Content

Toggle navigation
   
 * Product tour
 * Features
 * Guides
   

Login
Toggle navigation
   
 * Product tour
 * Features
 * Guides
   

Login
 * Team
 * List
   /v1/teams/
 * Report
 * Create
   /v1/reports/
 * List
   /v1/reports/
 * Standup
 * List
   /v1/standups/
 * Read
   /v1/standups/:id
 * Create
   /v1/standups/
 * Update
   /v1/standups/:id
 * Replace
   /v1/standups/:id
 * Duplicate
   /v1/standups/:id/duplicate
 * Delete
   /v1/standups/:id
 * Start
   /v1/standups/:id/start


WELCOME TO GEEKBOT'S API

In order to use the public API you need to obtain your API key and send it as
Authorization header. The API key can be found here.

1.0.0




TEAM


TEAM - LIST





Will return an object describing the team the API key was generated for.



get

https://api.geekbot.com/v1/teams/


HEADER

Field Type Description Authorization String

API token.


REPORT


REPORT - CREATE


post

https://api.geekbot.com/v1/reports/

 * Example usage:

curl -H "Authorization: $API_KEY" https://api.geekbot.com/v1/reports -d '{
  "standup_id":"1",
  "answers":{
     "123":{"text":"Cool"},
     "234":{"text":"Testing reports API"},
     "345":{"text":"Testing"},
     "456":{"text":"blocker testing"}
}}'


HEADER

Field Type Description Authorization String

API token.


BODY

Field Type Description standup_id Integer

Standup unique id

Associative String[]

array with question ids that point to text answers


REPORT - LIST


get

https://api.geekbot.com/v1/reports/


HEADER

Field Type Description Authorization String

API token.


QUERYSTRING

Field Type Description limit Number

Limit number of reports. Default is 30, maximum limit is 100.

standup_id Number

Receive reports for the specified standup only.

user_id Number

Receive reports from the specified user only.

after Number

Receive reports given after the specified timestamp.

before Number

Receive reports given before the specified timestamp.

question_ids Number[]

Receive answers to specific questions only.

html bool

Receive anwers with html formatting.


STANDUP


STANDUP - LIST


get

https://api.geekbot.com/v1/standups/

 * Example usage:

curl -i -H "Authorization: $API_KEY" https://api.geekbot.com/v1/standups/


HEADER

Field Type Description Authorization String

API token.


SUCCESS 200

Field Type Description root Object[]

List of standups.

  id Number

Standup unique id.

  time String

Time standup starts.

  wait_time Number

Minutes to wait after user logs in before asking question. Null value means no
automated asking.

  timezone String

Timezone used to calculate standup time.

  days String[]

List of days that standup is active.

  channel String

List of days that standup is active.

  questions Object[]

List of standup questions.

  users Object[]

List of users taking part in the standup.

  sync_channel_members bool

Standup participants are synced with channel members.


STANDUP - READ


get

https://api.geekbot.com/v1/standups/:id

 * Example usage:

curl -i -H "Authorization: $API_KEY" https://api.geekbot.com/v1/standups/15


HEADER

Field Type Description Authorization String

API token.


URL

Field Type Description id Number

Standup unique id.


SUCCESS 200

Field Type Description id Number

Standup unique id.

time String

Time standup starts.

wait_time Number

Minutes to wait after user logs in before asking question. Null value means no
automated asking.

timezone String

Timezone used to calculate standup time.

days String[]

List of days that standup is active.

channel String

List of days that standup is active.

questions Object[]

List of standup questions.

users Object[]

List of users taking part in the standup.

sync_channel_members bool

Standup participants are synced with channel members.


STANDUP - CREATE


post

https://api.geekbot.com/v1/standups/

 * Example usage:

curl -i -H "Authorization: $API_KEY" https://api.geekbot.com/v1/standups/ -d '{
  "name": "MyStandup",
  "channel": "#general",
  "time": "10:00:00",
  "timezone": "Europe/London",
  "wait_time": 10,
  "days": [ "Mon", "Wed", "Fri" ],
  "questions": [ { "question": "What did you do since yesterday?" }, { "question": "What will you do today?" } ],
  "users": [ 10, 11, 12 ]
}'


HEADER

Field Type Description Authorization String

API token.


BODY

Field Type Description name String

Standup name.

channel String

Standup broadcast channel.

time String

Time to ask standup in "HH:MM:SS" format.

timezone String

Timezone to use when calculating time to ask. If not specified, default is user
local.

wait_time optional Number

Minutes to wait after team member is online before asking question. Set to null
so that users do not get asked at all automatically.

days String[]

An array of 3-letter words that define days to ask, example ['Mon', 'Wed',
'Fri'].

questions optional Object[]

List of standup questions, an array of objects containing a "question" property.
If ommited, 3 Geekbot recommended questions will be used.

users Number[]

Array of user ids that will be included in the standup.

sync_channel_members bool

Standup participants will be synced with channel members.

personalised bool

Allow users to change their personal schedule for the standup


STANDUP - UPDATE





Allows partially updating standup. Any fields passed to the body will get
updated. This API call does not alter fields that are not present in the request
body.



patch

https://api.geekbot.com/v1/standups/:id

 * Example usage:

curl -i -H "Authorization: $API_KEY" -X PATCH https://api.geekbot.com/v1/standups/15 -d '{
  "name": "MyStandup",
  "channel": "#general",
  "time": "10:30:00",
  "timezone": "Europe/London",
  "wait_time": 15,
  "days": [ "Mon", "Wed", "Fri" ],
  "questions": [ { "question": "What did you do since yesterday?" }, { "question": "What will you do today?" } ],
  "users": [ 10, 11, 12 ],
  "sync_channel_members": false,
}'


HEADER

Field Type Description Authorization String

API token.


URL

Field Type Description id Number

Standup unique id.


BODY

Field Type Description channel optional String

Standup broadcast channel.

name optional String

Standup name.

time optional String

Time to ask standup in HHMM format.

timezone optional String

Timezone to use when calculating time to ask.

wait_time Number

Minutes to wait after team member is online before asking question. Set to null
so that users do not get asked at all automatically.

days optional String[]

An array of 3-letter words that define days to ask, example ['Mon', 'Wed',
'Fri']

questions optional Object[]

List of standup questions, an array of objects containing a "question" property.

users optional Number[]

Array of user ids that will be included in the standup.

sync_channel_members bool

Standup participants will be synced with channel members. If this is set to
"false" you need to provide the "users" parameter.

personalised bool

Allow users to change their personal schedule for the standup


STANDUP - REPLACE


put

https://api.geekbot.com/v1/standups/:id

 * Example usage:

curl -i -H "Authorization: $API_KEY" -X PUT https://api.geekbot.com/v1/standups/15 -d '{
  "name": "MyStandup",
  "channel": "#general",
  "time": "10:30:00",
  "timezone": "Europe/London",
  "wait_time": 15,
  "days": [ "Mon", "Wed", "Fri" ],
  "questions": [ { "question": "What did you do since yesterday?" }, { "question": "What will you do today?" } ],
  "users": [ 10, 11, 12 ],
  "sync_channel_members": false,
}'


HEADER

Field Type Description Authorization String

API token.


URL

Field Type Description id Number

Standup unique id.


BODY

Field Type Description channel String

Standup broadcast channel.

name String

Standup name.

time String

Time to ask standup in HHMM format.

timezone String

Timezone to use when calculating time to ask. If not specified, default is user
local.

wait_time Number

Minutes to wait after team member is online before asking question. Set to null
so that users do not get asked at all automatically.

days String[]

An array of 3-letter words that define days to ask, example ['Mon', 'Wed',
'Fri']

questions optional Object[]

List of standup questions, an array of objects containing a "question" property.
If ommited, 3 Geekbot recommended questions will be used.

users Number[]

Array of user ids that will be included in the standup.

sync_channel_members bool

Standup participants will be synced with channel members. If this is set to
"false" you need to provide the "users" parameter.


STANDUP - DUPLICATE





Allows duplication of a standup. Any fields passed to the body will be used to
create the new standup.



post

https://api.geekbot.com/v1/standups/:id/duplicate

 * Example usage:

curl -i -H "Authorization: $API_KEY" https://api.geekbot.com/v1/standups/15/duplicate -d '{
  "name": "DuplicatedStandup"
}'


HEADER

Field Type Description Authorization String

API token.


BODY

Field Type Description name String

Standup name (required).

channel String

Standup broadcast channel.

time String

Time to ask standup in "HH:MM:SS" format.

timezone String

Timezone to use when calculating time to ask. If not specified, default is user
local.

wait_time optional Number

Minutes to wait after team member is online before asking question. Set to null
so that users do not get asked at all automatically.

days String[]

An array of 3-letter words that define days to ask, example ['Mon', 'Wed',
'Fri'].

questions optional Object[]

List of standup questions, an array of objects containing a "question" property.
If ommited, 3 Geekbot recommended questions will be used.

users Number[]

Array of user ids that will be included in the standup.

sync_channel_members bool

Standup participants will be synced with channel members.

personalised bool

Allow users to change their personal schedule for the standup


STANDUP - DELETE


delete

https://api.geekbot.com/v1/standups/:id

 * Example usage:

curl -i -X DELETE -H "Authorization: $API_KEY" https://api.geekbot.com/v1/standups/15


HEADER

Field Type Description Authorization String

API token.


URL

Field Type Description id Number

Standup unique id.


STANDUP - START





Initiate a standup. If users param is given the standup will start only for the
users included



post

https://api.geekbot.com/v1/standups/:id/start

 * Example usage:

curl -i -H "Authorization: $API_KEY" -X POST https://api.geekbot.com/v1/standups/15/start -d '{
  "users": [ 10, 11, 12 ],
}'

or
curl -i -H "Authorization: $API_KEY" -X POST https://api.geekbot.com/v1/standups/15/start -d '{
  "emails": [ "a@example.com", "b@example.com" ],
}'


HEADER

Field Type Description Authorization String

API token.


URL

Field Type Description id Number

Standup unique id.


BODY

Field Type Description users String[]

Array of user ids that will be included in the standup.

emails String[]

Array of user emails that will be included in the standup.






WE CARE ABOUT YOUR PRIVACY

We use necessary cookies to make our site work. You may disable these by
changing your browser settings, but this may affect how the website functions.
We’d also like to set analytics cookies that help us make improvements by
measuring how you use the site. These will be set only if you accept.Check our
Cookie Policy



Cookie settings Reject all Accept all



PRIVACY PREFERENCE CENTER

We use necessary cookies to make our site work. You may disable these by
changing your browser settings, but this may affect how the website functions.
We’d also like to set analytics cookies that help us make improvements by
measuring how you use the site. These will be set only if you accept.Check our
Cookie Policy
Allow All


MANAGE CONSENT PREFERENCES

Essential cookies are always on. You have the option to turn off other cookie
types.

STRICTLY NECESSARY COOKIES

Always Active

These cookies are necessary for the website to function and cannot be switched
off in our systems. They are usually only set in response to actions made by you
which amount to a request for services, such as setting your privacy
preferences, logging in or filling in forms. You can set your browser to block
or alert you about these cookies, but some parts of the site will not then work.
These cookies do not store any personally identifiable information.

PERFORMANCE COOKIES

Performance Cookies

These cookies allow us to count visits and traffic sources so we can measure and
improve the performance of our site. They help us to know which pages are the
most and least popular and see how visitors move around the site. All
information these cookies collect is aggregated and therefore anonymous. If you
do not allow these cookies we will not know when you have visited our site, and
will not be able to monitor its performance.

TARGETING COOKIES

Targeting Cookies

These cookies may be set through our site by our advertising partners. They may
be used by those companies to build a profile of your interests and show you
relevant adverts on other sites. They do not store directly personal
information, but are based on uniquely identifying your browser and internet
device. If you do not allow these cookies, you will experience less targeted
advertising.

Back Button


PERFORMANCE COOKIES



Search Icon
Filter Icon

Clear
checkbox label label
Apply Cancel
Consent Leg.Interest
checkbox label label
checkbox label label
checkbox label label

Reject All Confirm My Choices