GlassFrog API v3
Overview
Status
API v3 is now the stable version of our API, and v2 is deprecated. With v3, we've upgraded the API to use and return json. If you are currently using v2, you can try out v3 at the same time without affecting your current integrations. While we will make reasonable attempts to keep them stable, we may still be changing any endpoint as we get feedback on usage.
Assignments
GETList all assignments for an organization
https://api.glassfrog.com/api/v3/assignments
HEADERS
X-Auth-Token
{token}
Content-Type
application/json
Example Request
List all assignments for an organization
curl
curl --location 'https://api.glassfrog.com/api/v3/assignments' \
--header 'X-Auth-Token: {token}' \
--header 'Content-Type: application/json'200 OK
Example Response
json
{
"linked": {
"people": [
{
"id": 911230097,
"name": "Monica Wolfson",
"email": "monica@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
},
{
"id": 905931655,
"name": "Alan Logue",
"email": "alan@fictional.com",
"external_id": "34",
"links": {
"circles": [
429327429,
856843816
]
}
},
{
"id": 656753429,
"name": "Vivian Eagle",
"email": "vivian@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
},
{
"id": 1030470515,
"name": "XSS Testuser",
"email": "xss@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
},
{
"id": 657190835,
"name": "Lawrence Copper",
"email": "lawrence@fictional.com",
"external_id": null,
"links": {
"circles": [
582240928,
1041583805
]
}
},
{
"id": 251465608,
"name": "Marlene Mclane",
"email": "marlene@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816,
1041583805
]
}
},
{
"id": 516784585,
"name": "Joyce Bilbrey",
"email": "joyce@fictional.com",
"external_id": null,
"links": {
"circles": [
1041583805,
856843816
]
}
},
{
"id": 943584124,
"name": "Maureen Linton",
"email": "maureen@fictional.com",
"external_id": null,
"links": {
"circles": [
1041583805,
856843816,
429327429
]
}
},
{
"id": 957904360,
"name": "Robert Ryder",
"email": "robert@fictional.com",
"external_id": null,
"links": {
"circles": [
906325632,
856843816
]
}
},
{
"id": 892961214,
"name": "Faye Falco",
"email": "faye@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
},
{
"id": 750111230,
"name": "Jeff Kahn",
"email": "jeff@fictional.com",
"external_id": null,
"links": {
"circles": [
429327429,
1041583805
]
}
},
{
"id": 811765527,
"name": "Carlos Aldrich",
"email": "carlos@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816,
582240928
]
}
}
],
"roles": [
{
"id": 584063925,
"name": "Technical Screener",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097,
656753429
]
}
},
{
"id": 815505102,
"name": "Board",
"purpose": null,
"links": {
"circle": null,
"supporting_circle": 429327429,
"domains": [],
"accountabilities": [],
"people": [
905931655
]
}
},
{
"id": 565839562,
"name": "Secretary",
"purpose": "Steward and stabilize the Circle’s formal records and record-keeping process.",
"elected_until": "2012-01-01",
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [
698697035,
1024896948
],
"accountabilities": [
976665104,
976665105,
976665106
],
"people": [
905931655
]
}
},
{
"id": 127110797,
"name": "Developer",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097,
656753429,
1030470515
]
}
},
{
"id": 959905549,
"name": "Secretary",
"purpose": "Steward and stabilize the Circle’s formal records and record-keeping process.",
"elected_until": null,
"links": {
"circle": 582240928,
"supporting_circle": null,
"domains": [
1024896945
],
"accountabilities": [
976665095,
976665096,
976665097
],
"people": [
657190835
]
}
},
{
"id": 1047607672,
"name": "Rep Link",
"purpose": "Within the Super-Circle, the Rep Link holds the Purpose of the SubCircle; within the Sub-Circle, the Rep Link’s Purpose is: Tensions relevant to process in the Super-Circle channeled out and resolved.",
"elected_until": "2012-01-01",
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [
976665087,
976665088,
976665089
],
"people": [
251465608
]
}
},
{
"id": 452413679,
"name": "Engagement Lead",
"purpose": "To drive an engagement within parameters defined by @Business_Analyst",
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [
260898271
],
"accountabilities": [
669580525
],
"people": [
911230097
]
}
},
{
"id": 629795917,
"name": "Apos'trophe",
"purpose": null,
"links": {
"circle": 582240928,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
657190835
]
}
},
{
"id": 95507013,
"name": "President",
"purpose": null,
"links": {
"circle": 1041583805,
"supporting_circle": null,
"domains": [
470645271
],
"accountabilities": [],
"people": [
516784585
]
}
},
{
"id": 352351748,
"name": "Lead Link",
"purpose": "Blow the client away with effortless software delivery.",
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [
1024896952
],
"accountabilities": [
976665058,
976665059,
976665060,
976665061,
976665062
],
"people": [
943584124
]
}
},
{
"id": 545244412,
"name": "Rep Link",
"purpose": "Within the Super-Circle, the Rep Link holds the Purpose of the SubCircle; within the Sub-Circle, the Rep Link’s Purpose is: Tensions relevant to process in the Super-Circle channeled out and resolved.",
"elected_until": "2017-01-01",
"links": {
"circle": 906325632,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
957904360
]
}
},
{
"id": 798917623,
"name": "Circle Member",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
811765527,
892961214
]
}
},
{
"id": 391279331,
"name": "Legal",
"purpose": null,
"links": {
"circle": 1041583805,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
750111230
]
}
},
{
"id": 550829580,
"name": "Rep Link",
"purpose": "Within the Super-Circle, the Rep Link holds the Purpose of the SubCircle; within the Sub-Circle, the Rep Link’s Purpose is: Tensions relevant to process in the Super-Circle channeled out and resolved.",
"elected_until": null,
"links": {
"circle": 1041583805,
"supporting_circle": null,
"domains": [],
"accountabilities": [
976665083,
976665084,
976665085
],
"people": [
943584124
]
}
},
{
"id": 227315657,
"name": "Lead Link",
"purpose": "Supporting @Sales and @Development",
"links": {
"circle": 582240928,
"supporting_circle": null,
"domains": [
1024896953
],
"accountabilities": [
976665065,
976665066,
976665067,
976665068,
976665069
],
"people": [
657190835
]
}
},
{
"id": 854229334,
"name": "This & That\"><img src=x onerror=\"javascript:alert(1)\">",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097
]
}
},
{
"id": 412385958,
"name": "Development",
"purpose": "Blow the client away with effortless software delivery.",
"links": {
"circle": 1041583805,
"supporting_circle": 856843816,
"domains": [
775947396,
989172342
],
"accountabilities": [
412385958
],
"people": [
943584124
]
}
},
{
"id": 905502603,
"name": "Principal Developer",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [
343214748,
168927033,
606076440,
1024896944
],
"accountabilities": [
221350223,
324345070,
591390822,
976665050
],
"people": [
516784585
]
}
},
{
"id": 475198276,
"name": "Lead Link",
"purpose": "To develop the healthiest possible system, where enlightenment thrives.",
"links": {
"circle": 1041583805,
"supporting_circle": null,
"domains": [
1024896951
],
"accountabilities": [
976665072,
976665073,
976665074,
976665075,
976665076
],
"people": [
750111230
]
}
},
{
"id": 502312354,
"name": "Operations",
"purpose": "Supporting @Sales and @Development",
"links": {
"circle": 1041583805,
"supporting_circle": 582240928,
"domains": [
753326398
],
"accountabilities": [
865781551
],
"people": [
657190835
]
}
},
{
"id": 826855511,
"name": "Lead Link",
"purpose": "To develop the healthiest possible system, where enlightenment thrives.",
"links": {
"circle": 429327429,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
905931655
]
}
},
{
"id": 83866836,
"name": "Crosslink Role",
"purpose": null,
"links": {
"circle": 582240928,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
811765527
]
}
},
{
"id": 686326666,
"name": "Secretary",
"purpose": "Steward and stabilize the Circle’s formal records and record-keeping process.",
"elected_until": null,
"links": {
"circle": 1041583805,
"supporting_circle": null,
"domains": [
1024896946
],
"accountabilities": [
976665098,
976665099,
976665100
],
"people": [
943584124
]
}
},
{
"id": 168116086,
"name": "GCC",
"purpose": "To develop the healthiest possible system, where enlightenment thrives.",
"links": {
"circle": 429327429,
"supporting_circle": 1041583805,
"domains": [],
"accountabilities": [],
"people": [
750111230
]
}
}
]
},
"assignments": [
{
"id": 401680832,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 911230097,
"role": 584063925
}
},
{
"id": 760354160,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 905931655,
"role": 815505102
}
},
{
"id": 109325862,
"election": null,
"exclude_from_meetings": false,
"focus": "C++",
"links": {
"person": 656753429,
"role": 584063925
}
},
{
"id": 721490231,
"election": "2012-01-01",
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 905931655,
"role": 565839562
}
},
{
"id": 705864669,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 1030470515,
"role": 127110797
}
},
{
"id": 772444994,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 657190835,
"role": 959905549
}
},
{
"id": 647257311,
"election": "2012-01-01",
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 251465608,
"role": 1047607672
}
},
{
"id": 462762721,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 911230097,
"role": 452413679
}
},
{
"id": 950420747,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 657190835,
"role": 629795917
}
},
{
"id": 500857258,
"election": null,
"exclude_from_meetings": true,
"focus": null,
"links": {
"person": 516784585,
"role": 95507013
}
},
{
"id": 1035055182,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 943584124,
"role": 352351748
}
},
{
"id": 373917675,
"election": "2017-01-01",
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 957904360,
"role": 545244412
}
},
{
"id": 154534532,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 892961214,
"role": 798917623
}
},
{
"id": 873098090,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 911230097,
"role": 127110797
}
},
{
"id": 875223453,
"election": null,
"exclude_from_meetings": true,
"focus": null,
"links": {
"person": 750111230,
"role": 391279331
}
},
{
"id": 901998243,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 943584124,
"role": 550829580
}
},
{
"id": 852415656,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 657190835,
"role": 227315657
}
},
{
"id": 137368841,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 911230097,
"role": 854229334
}
},
{
"id": 139225473,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 943584124,
"role": 412385958
}
},
{
"id": 173373687,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 516784585,
"role": 905502603
}
},
{
"id": 901526610,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 750111230,
"role": 475198276
}
},
{
"id": 470649790,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 811765527,
"role": 798917623
}
},
{
"id": 659677258,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 657190835,
"role": 502312354
}
},
{
"id": 893206043,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 905931655,
"role": 826855511
}
},
{
"id": 310398587,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 811765527,
"role": 83866836
}
},
{
"id": 629107964,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 656753429,
"role": 127110797
}
},
{
"id": 715839995,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 943584124,
"role": 686326666
}
},
{
"id": 276051491,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 750111230,
"role": 168116086
}
}
]
}Access-Control-Allow-Headers
*,x-requested-with,Content-Type,If-Modified-Since,If-None-Match,X-Auth-Token
Access-Control-Allow-Methods
GET, POST, PATCH, PUT, DELETE, OPTIONS, HEAD
Access-Control-Allow-Origin
*
Access-Control-Expose-Headers
ETag
Access-Control-Max-Age
86400
Cache-Control
max-age=0, private, must-revalidate
Content-Type
application/json; charset=utf-8
ETag
"48599105cc7cbe115d67e990db0f1477"
Set-Cookie
_development_glassfrog_secure_session_2=SUxrdjIxanU3azM3TFBuSnhkNXdyL1ExbjR2SlpDcXhhazNRUVJrNDVhZzFtcytELzB3WnRPd0pzdy94b1NXQjBtdWRnMlBHL0IwM2gzQVU2VDRyVmZWVDJRN3hmRC9nSUF5dUZBc295VW5OQmRRTDZaRFNNU1lsVmowUzY5K1hiMndrTTVzSHdjY0J6bTVkNGsrTHUwVWpRa0p5RXp4bk5SRWV4M2VsdlYzWUdySkl6UUdJdG9tUHJ3dFBPeUpBL2FhSTFzdzdFU0FsQUhJL3labHFOdm1LN3JYRGRIK1k4c0IzMDZHZ1JBL3l0amhsZUUydkVBcEVHVllNMjY2bGwrZXUxcmMrcGVsaUJYc1NieXNqRS84dzlqYm9rY0dCZ3NCWWx4b3Q2dXc9LS1kNGc1MWRPeEZiRmI0TXlMVWlFSnZ3PT0%3D--4e222634fe5249bbb3ba116259beb02cc68198e7; domain=.glassfrog.dev; path=/; HttpOnly
Transfer-Encoding
chunked
X-Content-Type-Options
nosniff
X-Download-Options
noopen
X-Frame-Options
sameorigin
X-Permitted-Cross-Domain-Policies
none
X-Request-Id
748d2711-4c9e-46fd-a293-c7feaec1d869
X-Runtime
5.635366
X-UA-Compatible
chrome=1
X-XSS-Protection
1; mode=block
GETGet the assignments for a person
https://api.glassfrog.com/api/v3/people/{person_id}/assignments
HEADERS
X-Auth-Token
{token}
Content-Type
application/json
Example Request
Get the assignments for a person
curl
curl --location -g 'https://api.glassfrog.com/api/v3/people/{person_id}/assignments' \
--header 'X-Auth-Token: {token}' \
--header 'Content-Type: application/json'200 OK
Example Response
javascript
{
"linked": {
"people": [
{
"id": 656753429,
"name": "Vivian Eagle",
"email": "vivian@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
}
],
"roles": [
{
"id": 127110797,
"name": "Developer",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097,
656753429,
1030470515
]
}
},
{
"id": 584063925,
"name": "Technical Screener",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097,
656753429
]
}
}
]
},
"assignments": [
{
"id": 629107964,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 656753429,
"role": 127110797
}
},
{
"id": 109325862,
"election": null,
"exclude_from_meetings": false,
"focus": "C++",
"links": {
"person": 656753429,
"role": 584063925
}
}
]
}Access-Control-Allow-Headers
*,x-requested-with,Content-Type,If-Modified-Since,If-None-Match,X-Auth-Token
Access-Control-Allow-Methods
GET, POST, PATCH, PUT, DELETE, OPTIONS, HEAD
Access-Control-Allow-Origin
*
Access-Control-Expose-Headers
ETag
Access-Control-Max-Age
86400
Cache-Control
max-age=0, private, must-revalidate
Connection
Keep-Alive
Content-Length
777
Content-Type
application/json; charset=utf-8
Date
Thu, 10 Nov 2016 22:03:27 GMT
Etag
"a4b6c0c3d97790fb85a6f1228dfc74b9"
Server
WEBrick/1.3.1 (Ruby/2.0.0/2015-12-16)
X-Content-Type-Options
nosniff
X-Download-Options
noopen
X-Frame-Options
sameorigin
X-Permitted-Cross-Domain-Policies
none
X-Request-Id
47180a81-fdbe-4cba-9fd8-db4668b0b4cc
X-Runtime
0.161680
X-Ua-Compatible
chrome=1
X-Xss-Protection
1; mode=block
GETGet the assignments for a role
https://api.glassfrog.com/api/v3/roles/{role_id}/assignments
HEADERS
X-Auth-Token
{token}
Content-Type
application/json
Example Request
Get the assignments for a role
curl
curl --location -g 'https://api.glassfrog.com/api/v3/roles/{role_id}/assignments' \
--header 'X-Auth-Token: {token}' \
--header 'Content-Type: application/json'200 OK
Example Response
javascript
{
"linked": {
"people": [
{
"id": 656753429,
"name": "Vivian Eagle",
"email": "vivian@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
},
{
"id": 911230097,
"name": "Monica Wolfson",
"email": "monica@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
},
{
"id": 1030470515,
"name": "XSS Testuser",
"email": "xss@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
}
],
"roles": [
{
"id": 127110797,
"name": "Developer",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097,
656753429,
1030470515
]
}
}
]
},
"assignments": [
{
"id": 629107964,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 656753429,
"role": 127110797
}
},
{
"id": 873098090,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 911230097,
"role": 127110797
}
},
{
"id": 705864669,
"election": null,
"exclude_from_meetings": false,
"focus": null,
"links": {
"person": 1030470515,
"role": 127110797
}
}
]
}Access-Control-Allow-Headers
*,x-requested-with,Content-Type,If-Modified-Since,If-None-Match,X-Auth-Token
Access-Control-Allow-Methods
GET, POST, PATCH, PUT, DELETE, OPTIONS, HEAD
Access-Control-Allow-Origin
*
Access-Control-Expose-Headers
ETag
Access-Control-Max-Age
86400
Cache-Control
max-age=0, private, must-revalidate
Connection
Keep-Alive
Content-Length
961
Content-Type
application/json; charset=utf-8
Date
Thu, 10 Nov 2016 22:03:34 GMT
Etag
"056934924ca53a6f1afd73a007f51f13"
Server
WEBrick/1.3.1 (Ruby/2.0.0/2015-12-16)
X-Content-Type-Options
nosniff
X-Download-Options
noopen
X-Frame-Options
sameorigin
X-Permitted-Cross-Domain-Policies
none
X-Request-Id
a58ad1fa-1ca3-4e6e-abe3-9b528d3f08a9
X-Runtime
0.080898
X-Ua-Compatible
chrome=1
X-Xss-Protection
1; mode=block
POSTCreate a role assignment
https://api.glassfrog.com/api/v3/assignments
HEADERS
X-Auth-Token
{token}
Content-Type
application/json
Bodyraw
{
"assignments": [
{
"focus": "Only some of the work",
"exclude_from_meetings": false,
"links": {
"role": {role_id},
"person": {person_id}
}
}
]
}
Example Request
Create a role assignment
curl
curl --location 'https://api.glassfrog.com/api/v3/assignments' \
--header 'X-Auth-Token: {token}' \
--header 'Content-Type: application/json' \
--data '{
"assignments": [
{
"focus": "Only some of the work",
"exclude_from_meetings": false,
"links": {
"role": {role_id},
"person": {person_id}
}
}
]
}
'200 OK
Example Response
javascript
{
"linked": {
"people": [
{
"id": 724127205,
"name": "Wendy Pagano",
"email": "wendy@fictional.com",
"external_id": null,
"links": {
"circles": [
856843816
]
}
}
],
"roles": [
{
"id": 127110797,
"name": "Developer",
"purpose": null,
"links": {
"circle": 856843816,
"supporting_circle": null,
"domains": [],
"accountabilities": [],
"people": [
911230097,
724127205,
656753429,
1030470515
]
}
}
]
},
"assignments": [
{
"id": 1035055183,
"election": null,
"exclude_from_meetings": false,
"focus": "Only some of the work",
"links": {
"person": 724127205,
"role": 127110797
}
}
]
}Access-Control-Allow-Headers
*,x-requested-with,Content-Type,If-Modified-Since,If-None-Match,X-Auth-Token
Access-Control-Allow-Methods
GET, POST, PATCH, PUT, DELETE, OPTIONS, HEAD
Access-Control-Allow-Origin
*
Access-Control-Expose-Headers
ETag
Access-Control-Max-Age
86400
Cache-Control
max-age=0, private, must-revalidate
Connection
Keep-Alive
Content-Length
503
Content-Type
application/json; charset=utf-8
Date
Thu, 10 Nov 2016 22:03:44 GMT
Etag
"b0bb48da24f131477d1cd860d3ffa5e5"
Location
http://app.glassfrog.dev:3000/api/v3/assignments/1035055183
Server
WEBrick/1.3.1 (Ruby/2.0.0/2015-12-16)
X-Content-Type-Options
nosniff
X-Download-Options
noopen
X-Frame-Options
sameorigin
X-Permitted-Cross-Domain-Policies
none
X-Request-Id
9d7d664b-d147-43a2-b8d2-7388026671db
X-Runtime
1.470921
X-Ua-Compatible
chrome=1
X-Xss-Protection
1; mode=block